FrameLib_Context.h

Go to the documentation of this file.

#ifndef FRAMELIB_CONTEXT_H
#define FRAMELIB_CONTEXT_H

#include "FrameLib_Types.h"
#include "FrameLib_Global.h"
#include "FrameLib_Errors.h"

class FrameLib_Context
{    
    using Global = FrameLib_Global;
    
    // Comparisions
    
    friend bool operator == (const FrameLib_Context& a, const FrameLib_Context& b)
    {
        return a.mGlobal == b.mGlobal && a.mReference == b.mReference;
    }
    
    friend bool operator != (const FrameLib_Context& a, const FrameLib_Context& b)
    {
        return !(a == b);
    }
    
    template <class T, T *(Global::*getMethod)(void *), void(Global::*releaseMethod)(void *)>
    class ManagedPointer
    {
        
    public:
        
        // Constructor / Destructor
        
        ManagedPointer(const FrameLib_Context &context) : mGlobal(context.mGlobal), mReference(context.mReference)
        {
            mPointer = (mGlobal->*getMethod)(mReference);
        }
        
        ~ManagedPointer()
        {
            release();
        }
        
        // Non-copyable
        
        ManagedPointer(const ManagedPointer&) = delete;
        ManagedPointer& operator=(const ManagedPointer&) = delete;
        
        // Release
        
        void release()
        {
            if (mGlobal)
                (mGlobal->*releaseMethod)(mReference);
            mPointer = nullptr;
            mGlobal = nullptr;
            mReference = nullptr;
        }
        
        // Pointer  / Bool Conversion
        
        T *operator->()         { return mPointer; }
        operator bool() const   { return mPointer != nullptr; }
        
    private:
        
        // Member Variables
        
        T *mPointer;
        FrameLib_Global *mGlobal;
        void *mReference;
    };

public:
    
    // Constructor - the reference should be a suitable reference address in the host environment
    
    FrameLib_Context(FrameLib_Global *global, void *reference) : mGlobal(global), mReference(reference) {}
    
    // Construct one of these objects to retain a relevant object
    
    using Allocator = ManagedPointer<FrameLib_LocalAllocator, &Global::getAllocator, &Global::releaseAllocator>;
    using ProcessingQueue = ManagedPointer<FrameLib_ProcessingQueue, &Global::getProcessingQueue, &Global::releaseProcessingQueue>;

    // Get the global as a FrameLib_ErrorReporter from the context
    
    operator FrameLib_ErrorReporter&() { return *mGlobal; }
    
private:
    
    // Member Variables

    FrameLib_Global *mGlobal;
    void *mReference;
};


#endif